#4.x 移行ガイド

Chart.js 4.0 では、多数の重大な変更が導入されています。私たちは互換性を損なう変更の量を最小限に抑えるよう努めました。一部の機能やバグ修正では、下位互換性を解除する必要がありましたが、メリットがある場合にのみそうすることを目指しました。

#エンドユーザーの移行

#チャート

• グラフはデフォルトのツールチップ コールバックをオーバーライドしないため、すべてのグラフ タイプに同じ外観のツールチップが表示されます。
• 設定されたスケールが次で始まる場合、デフォルトのスケール オーバーライドは削除されました。x/y。定義するxAxes設定で、デフォルトをオーバーライドする代わりに 2 番目のスケールを作成するようになりました。x軸。

#オプション

に渡される構成オプションに多くの変更が加えられました。Chartコンストラクタ。これらの変更は以下に文書化されています。

#具体的な変更点

• radioLinear グリッドのインデックス可能オプションとスクリプト可能オプションは、指定されたグリッド ラインのインデックスを減らさなくなりました。
• のdestroyプラグインフックが削除され、次のように置き換えられました。afterDestroy。
• タイム スケールのティック コールバックは、書式設定されたラベルの代わりにタイムスタンプを受け取るようになりました。
• scales[id].grid.drawBorderに名前が変更されましたscales[id].border.display。
• scales[id].grid.borderWidthに名前が変更されましたscales[id].border.width。
• scales[id].grid.borderColorに名前が変更されましたscales[id].border.color。
• scales[id].grid.borderDashに名前が変更されましたscales[id].border.dash。
• scales[id].grid.borderDashOffsetに名前が変更されましたscales[id].border.dashOffset。
• スケールの境界の Z インデックスを、グリッドの Z インデックスより 1 つ大きくする代わりに設定できるようになりました。
• リニアスケールの加算と減算が可能になりました5%最小値と最大値が同じ場合は、最大値を範囲に適用します。1。
• ツールチップのコールバックが返された場合undefinedの場合、デフォルトのコールバックが使用されます。
• maintainAspectRatioコンテナの高さを考慮します。
• 時間と時系列スケールの使用ticks.stepSizeそれ以外のtime.stepSize、削除されました。
• maxTickslimitのティックには使用されませんautoSkip決定された最大ティックが以下の場合、maxTicksLimit。
• dist/chart.jsは削除されました。
• dist/chart.min.jsに名前が変更されましたdist/chart.umd.js。
• dist/chart.esm.jsに名前が変更されましたdist/chart.js。

#タイプの変更

• の順序は、ChartMetaパラメータはから変更されました<Element, DatasetElement, Type>に<Type, Element, DatasetElement>。

#全般的

• Chart.js はESM 専用パッケージ (新しいウィンドウが開きます)(UMDバンドルはまだ入手可能です）。 Chart.js を使用するには、プロジェクトも ES モジュールである必要があります。これを必ず入れておいてくださいpackage.json:

  {
    "type": "module"
  }
  

  問題が発生している場合は、冗談 (新しいウィンドウが開きます)、それに従うドキュメンテーション (新しいウィンドウが開きます)ESM サポートを有効にします。または、次への移行をお勧めします。ヴィテスト (新しいウィンドウが開きます)。 Vitest にはすぐに使える ESM サポートがあり、Jestとほぼ同じAPI (新しいウィンドウが開きます)。を参照してください。移住の例 (新しいウィンドウが開きます)。
• へのフォールバックを削除しましたfontColor凡例のテキストと取り消し線の色。
• 削除されましたconfig._chartのフォールバックthis.chartフィラープラグインで。
• 削除されましたthis._chartフィラープラグインで。